IRIX Base Documentation 2001 May

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / X11 / xlock.z / xlock

Wrap

Text File | 2001-04-17 | 20.5 KB | 397 lines

XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111)))) NNNNAAAAMMMMEEEE xlock - Locks the local X display until a password is entered. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS xxxxlllloooocccckkkk [ ----ddddiiiissssppppllllaaaayyyy dsp ] [ ----hhhheeeellllpppp ] [ ----nnnnaaaammmmeeee resource-name ] [ ----rrrreeeessssoooouuuurrrrcccceeeessss ] [ ----bbbbllllaaaannnnkkkktttthhhhrrrreeeesssshhhh num ] [ ----////++++rrrreeeemmmmooootttteeee ] [ ----////++++mmmmoooonnnnoooo ] [ ----////++++nnnnoooolllloooocccckkkk ] [ ----////++++aaaalllllllloooowwwwrrrrooooooootttt ] [ ----////++++bbbbeeeessssaaaavvvveeeerrrr ] [ ----////++++aaaalllllllloooowwwwaaaacccccccceeeessssssss ] [ ----////++++eeeecccchhhhooookkkkeeeeyyyyssss ] [ ----////++++vvvv ] [ ----////++++uuuusssseeeeffffiiiirrrrsssstttt ] [ ----ddddeeeellllaaaayyyy usecs ] [ ----bbbbaaaattttcccchhhhccccoooouuuunnnntttt num ] [ ----ccccoooolllloooorrrrccccoooouuuunnnntttt num ] [ ----nnnniiiicccceeee level ] [ ----ttttiiiimmmmeeeeoooouuuutttt seconds ] [ ----ssssaaaattttuuuurrrraaaattttiiiioooonnnn value ] [ ----ffffoooonnnntttt fontname ] [ ----bbbbgggg color ] [ ----ffffgggg color ] [ ----mmmmooooddddeeee mode ] [ ----uuuusssseeeerrrrnnnnaaaammmmeeee textstring ] [ ----ppppaaaasssssssswwwwoooorrrrdddd textstring ] [ ----iiiinnnnffffoooo textstring ] [ ----vvvvaaaalllliiiiddddaaaatttteeee textstring ] [ ----iiiinnnnvvvvaaaalllliiiidddd textstring ] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN xxxxlllloooocccckkkk blanks (or otherwise saves) the screen and possibly locks the X server till the user enters their password at the keyboard. While xxxxlllloooocccckkkk is has the screen locked, all new server connections are refused. The screen saver is disabled. The mouse cursor is turned off. The screen is blanked and a changing pattern is put on the screen. If a key or a mouse button is pressed then the user is prompted for the password of the user who started xxxxlllloooocccckkkk.... If the correct password is typed, then the screen is unlocked and the X server is restored. When typing the password Control-U and Control-H are active as kill and erase respectively. To return to the locked screen, click in the small icon version of the changing pattern. If the screen is merely saved, but not locked, or if the user who started the program does not have a password, then no password is required. OOOOPPPPTTTTIIIIOOOONNNNSSSS ----ddddiiiissssppppllllaaaayyyy ddddsssspppp The _d_i_s_p_l_a_y option sets the X11 display to lock. xxxxlllloooocccckkkk locks all available screens on a given server, and restricts you to locking only a local server such as uuuunnnniiiixxxx::::0000,,,, llllooooccccaaaallllhhhhoooosssstttt::::0000,,,, or ::::0000 unless you set the ----rrrreeeemmmmooootttteeee option. ----nnnnaaaammmmeeee rrrreeeessssoooouuuurrrrcccceeee----nnnnaaaammmmeeee _r_e_s_o_u_r_c_e-_n_a_m_e is used instead of XXXXLLLLoooocccckkkk when looking for resources to configure xlock. Page 1 (printed 4/6/01) XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111)))) ----mmmmooooddddeeee mmmmooooddddeeeennnnaaaammmmeeee As of this writing there are ten display modes supported (plus one more for random selection of one of the ten). bbbbllllaaaannnnkkkk Blank mode shows nothing but a black screen. rrrroooottttoooorrrr Rotor mode shows a swirling rotorlike thing. ppppyyyyrrrroooo Pyro mode shows lots of small fireworks. ffffllllaaaammmmeeee Flame mode shows wierd but cool cosmic flame fractals. hhhhoooopppp Hop mode shows the "real plane fractals" from the September 1986 issue of Scientific American. iiiimmmmaaaaggggeeee Image mode shows several sgi logos randomly appearing on the screen. lllliiiiffffeeee Life mode shows Conway's game of life. ppppoooopppp Pop mode shows single large fireworks exploding on the screen. qqqqiiiixxxx Qix mode shows the spinning lines similar to the old video game by the same name. sssswwwwaaaarrrrmmmm Swarm mode shows a swarm of bees following a wasp. rrrraaaannnnddddoooommmm Selects one of the above modes randomly. ----ddddeeeellllaaaayyyy uuuusssseeeeccccssss The _d_e_l_a_y option sets the speed at which a mode will operate. It simply sets the number of microseconds to delay between batches of "hopalong pixels", "qix lines", "life generations", "image blits", and "pop or swarm motions". In blank mode, it is important to set this to some small number of seconds, because the keyboard and mouse are only checked after each delay, so you cannot set the delay too high, but a delay of zero would needlessly consume cpu checking for mouse and keyboard input in a tight loop, since blank mode has no work to do. ----bbbbaaaattttcccchhhhccccoooouuuunnnntttt nnnnuuuummmm The _b_a_t_c_h_c_o_u_n_t option sets the number of _t_h_i_n_g_s to do per batch to _n_u_m . In qix mode this refers to the number of lines rendered in the same color. In life mode it is the number of generations to let each species live. In hop mode this refers to the number of Page 2 (printed 4/6/01) XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111)))) pixels rendered in the same color. In image mode this refers to the number of sgilogos on screen at once. In swarm mode this refers to the number of bees. In rotor mode it is the number of rotor thingys which whirr... In pyro mode it is the maximum number flying rockets at one time. In flame mode it is the number of levels to recurse (larger = more complex). In pop mode this sets the maximum number of sparks in a burst (the actual number of sparts in any one burst is chosen randomly). In blank mode it means nothing. ----ccccoooolllloooorrrrccccoooouuuunnnntttt nnnnuuuummmm The _c_o_l_o_r_c_o_u_n_t option sets the number of colors to use to _n_u_m . ----nnnniiiicccceeee nnnniiiicccceeeelllleeeevvvveeeellll The _n_i_c_e option sets system nicelevel of the xlock process to _n_i_c_e_l_e_v_e_l . ----ttttiiiimmmmeeeeoooouuuutttt sssseeeeccccoooonnnnddddssss The _t_i_m_e_o_u_t option sets the number of _s_e_c_o_n_d_s before the password screen will time out. ----ssssaaaattttuuuurrrraaaattttiiiioooonnnn vvvvaaaalllluuuueeee The _s_a_t_u_r_a_t_i_o_n option sets saturation of the color ramp used to _v_a_l_u_e . 0 is grayscale and 1 is very rich color. 0.4 is a nice pastel. ----ffffoooonnnntttt ffffoooonnnnttttnnnnaaaammmmeeee The _f_o_n_t option sets the font to be used on the prompt screen. ----ffffgggg ccccoooolllloooorrrr The _f_g option sets the color of the text on the password screen to _c_o_l_o_r . ----bbbbgggg ccccoooolllloooorrrr The _b_g option sets the color of the background on the password screen to _c_o_l_o_r . ----uuuusssseeeerrrrnnnnaaaammmmeeee tttteeeexxxxttttssssttttrrrriiiinnnngggg _t_e_x_t_s_t_r_i_n_g is shown in front of user name, defaults to "Name: ". ----ppppaaaasssssssswwwwoooorrrrdddd tttteeeexxxxttttssssttttrrrriiiinnnngggg _t_e_x_t_s_t_r_i_n_g is the password prompt string, defaults to "Password: ". ----iiiinnnnffffoooo tttteeeexxxxttttssssttttrrrriiiinnnngggg _t_e_x_t_s_t_r_i_n_g is an informational message to tell the user what to do, defaults to "Enter password to unlock; select icon to lock.". Page 3 (printed 4/6/01) XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111)))) ----vvvvaaaalllliiiiddddaaaatttteeee _t_e_x_t_s_t_r_i_n_g _t_e_x_t_s_t_r_i_n_g ----vvvvaaaalllliiiiddddaaaatttteeee _m_e_s_s_a_g_e _s_h_o_w_n _w_h_i_l_e _v_a_l_i_d_a_t_i_n_g _t_h_e _p_a_s_s_w_o_r_d, _d_e_f_a_u_l_t_s _t_o "Validating login..." ----iiiinnnnvvvvaaaalllliiiidddd _t_e_x_t_s_t_r_i_n_g _t_e_x_t_s_t_r_i_n_g ----iiiinnnnvvvvaaaalllliiiidddd _m_e_s_s_a_g_e _s_h_o_w_n _w_h_e_n _p_a_s_s_w_o_r_d _i_s _i_n_v_a_l_i_d, _d_e_f_a_u_l_t_s _t_o "Invalid login." ----rrrreeeessssoooouuuurrrrcccceeeessss The _r_e_s_o_u_r_c_e_s option prints the default resource file for xlock to standard output. ----////++++rrrreeeemmmmooootttteeee The _r_e_m_o_t_e option tells xlock to not stop you from locking remote X11 servers. This option should be used with care and is intended mainly to lock X11 terminals which cannot run _x_l_o_c_k locally. If you lock someone else's workstation, they will have to know yyyyoooouuuurrrr password to unlock it. ----////++++mmmmoooonnnnoooo The _m_o_n_o option causes xlock to display monochrome, (black and white) pixels rather than the default colored ones on color displays ----////++++nnnnoooolllloooocccckkkk The _n_o_l_o_c_k option causes xlock to only draw the patterns and not lock the display. A keypress or a mouse click will terminate the screen saver or send it back into the background (with ----bbbbeeeessssaaaavvvveeeerrrr). ----////++++aaaalllllllloooowwwwrrrrooooooootttt The _a_l_l_o_w_r_o_o_t option allows the root password to unlock the server as well as the user who started xlock. ----////++++eeeennnnaaaabbbblllleeeessssaaaavvvveeeerrrr By default xlock will disable the normal X server's screen saver since it is in effect a replacement for it. Since it is possible to set delay parameters long enough to cause phosphor burn on some displays, this option will turn back on the default screensaver which is very careful to keep most of the screen black. ----////++++bbbbeeeessssaaaavvvveeeerrrr If your X server supports the SCREEN-SAVER protocol, then this option will tell xlock to act as the screen saver. When you use xlock in this mode, it will not lock the screen immediately. Instead, when the server decides the screen should be blanked, it will notify xlock instead of merely blanking the screen. Xlock will then display whatever display mode you have Page 4 (printed 4/6/01) XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111)))) selected. In this mode, xlock will not exit when you type in a password. Instead, its window will disappear, and it will wait for the next screen saver time out. This option forces ----eeeennnnaaaabbbblllleeeessssaaaavvvveeeerrrr.... ----bbbbllllaaaannnnkkkktttthhhhrrrreeeesssshhhh _n_u_m Whenever xlock is displaying some graphic mode and the system load rises over this value, xlock will switch to blank mode. Since blank mode is much less expensive than many of the graphic modes, this will allow time for other system activity. ----////++++aaaalllllllloooowwwwaaaacccccccceeeessssssss This option is required for servers which do not allow clients to modify the host access control list. It is also useful if you need to run x clients on a server which is locked for some reason... When allowaccess is true, the X11 server is left open for clients to attach and thus lowers the inherent security of this lockscreen. A side effect of using this option is that if xlock is killed -KILL, the access control list is not lost. ----////++++eeeecccchhhhooookkkkeeeeyyyyssss The _e_c_h_o_k_e_y_s option causes xlock to echo '?' characters for each key typed into the password prompt. Some consider this a security risk, so the default is to not echo anything. ----////++++uuuusssseeeeffffiiiirrrrsssstttt The _u_s_e_f_i_r_s_t option causes xlock to use the keystroke which got you to the password screen as the first character in the password. The default is to ignore the first key pressed. ----vvvv Verbose mode, tells what options it is going to use. BBBBUUUUGGGGSSSS "kill -KILL xxxxlllloooocccckkkk " causes the server that was locked to be unusable, since all hosts (including localhost) were removed from the access control list to lock out new X clients, and since xlock couldn't catch SIGKILL, it terminated before restoring the access control list. This will leave the X server in a state where "_y_o_u _c_a_n _n_o _l_o_n_g_e_r _c_o_n_n_e_c_t _t_o _t_h_a_t _s_e_r_v_e_r, _a_n_d _t_h_i_s _o_p_e_r_a_t_i_o_n _c_a_n_n_o_t _b_e _r_e_v_e_r_s_e_d _u_n_l_e_s_s _y_o_u _r_e_s_e_t _t_h_e _s_e_r_v_e_r." -From the X11R4 Xlib Documentation, Chapter 7. Page 5 (printed 4/6/01) XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111)))) On some kernel and hardware combinations, ppppoooopppp mode will cause trashy flickering at the top of the screen. This is a bug in the graphics library/kernel/hardware (depending on how you look at it) and is out of xxxxlllloooocccckkkk's control. NNNNOOOOTTTTEEEE If you run xxxxlllloooocccckkkk on a machine not running the kernel in /unix, you can potentially confuse xxxxlllloooocccckkkk since it will not be able to measure the load correctly. If the load appears too far out of range, xxxxlllloooocccckkkk will print a message to that affect and disable the load threshold checking. SSSSEEEEEEEE AAAALLLLSSSSOOOO X(1), xset(1), Xlib Documentation. AAAAUUUUTTTTHHHHOOOORRRR Patrick J. Naughton (naughton@eng.sun.com) Mailstop 10-20 Sun Laboratories, Inc. Mountain View, CA 94043 415/336-1080 CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT Copyright (c) 1988-91 by Patrick J. Naughton Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. Page 6 (printed 4/6/01)